home *** CD-ROM | disk | FTP | other *** search
/ Scene Storm / Scene Storm - Volume 1.iso / coding / tools / gcc / ixm-doc.lha / ixemul / INSTALL < prev    next >
Encoding:
Text File  |  1996-01-18  |  6.6 KB  |  181 lines
  1.  
  2.             IXEMUL  LIBRARY  INSTALLATION  NOTES
  3.  
  4.                (last updated 9-Jan-96)
  5.  
  6.  
  7. =====================
  8. DISTRIBUTION CONTENTS
  9. =====================
  10.  
  11. The net ixemul library distribution consists of several archives:
  12.  
  13.   ixemul-bin.lha    Utils for gnu/bin, like ixtrace and ixconfig
  14.  
  15.   ixemul-sdk.lha    Files needed to build applications that use
  16.             ixemul.library.
  17.  
  18.   ixemul-doc.lha    Various documentation, such as this file
  19.  
  20.   ixemul-src.tgz    Complete source code for ixemul library as
  21.             a gzip compressed tar archive.
  22.  
  23.   ixemul-tz.lha        Pieces for doing TZ (timezone) management
  24.  
  25.   ixemul-CCCF.lha    Specific flavors of the library, where 'CCC'
  26.             is one of 000, 020, 030, or 040, for 68000, 68020,
  27.             68030, and 68040 respectively, and 'F' is either
  28.             'f', 's', or 't' for FPU support or soft floating
  29.             point or a "trace" version (also soft float)
  30.             respectively.
  31.  
  32. The ixemul-doc.lha archive contains various readme and copyright files that
  33. do not need to be installed anywhere.  The ixemul-src.tgz archive contains
  34. the source tree that can be installed anywhere.  The rest of the archives
  35. should simply be extracted relative to the gnu: directory to put all the
  36. files in their standard location.
  37.  
  38. ========================
  39. INSTALLING RUNTIME FILES
  40. ========================
  41.  
  42. For the moment, you must manually install the files.  Eventually there will
  43. be an installer script available that you can use with the standard AmigaDOS
  44. installer program to make installation more WorkBench friendly.
  45.  
  46. First backup any files in gnu: that will get overwritten during the install,
  47. if you wish to preserve them.  These files typically are:
  48.  
  49.     gnu:bin/ixconfig
  50.     gnu:bin/ixtrace
  51.     gnu:lib/bcrt0.o
  52.     gnu:lib/crt0.o
  53.     gnu:lib/rcrt0.o
  54.     gnu:lib/libc.a
  55.     gnu:lib/libb/libc.a
  56.     gnu:include        (lots of files, but probably not all)
  57.     gnu:man            (lots of files, but probably not all)
  58.     gnu:etc            (lots of files, but probably not all)
  59.     gnu:Sys/libs/ixemul*    (all the old versions of the library)
  60.  
  61. Change directory to gnu: and extract the contents of ixemul-bin.lha,
  62. ixemul-sdk.lha (if you expect to be building any ixemul.library using
  63. applications), ixemul-tz.lha (optional) and any ixemul-XXXX.lha archives
  64. that you want, overwriting any existing copies of the files in your gnu
  65. tree.  For example, to install the utils, sdk, and both the 68000 and
  66. 68040+68881 versions of the library, do the following:
  67.  
  68.     lha -mraxe x ixemul-bin.lha gnu:
  69.     lha -mraxe x ixemul-sdk.lha gnu:
  70.     lha -mraxe x ixemul-000.lha gnu:
  71.     lha -mraxe x ixemul-040f.lha gnu:
  72.  
  73. Now you need to decide which version of the library to use, based on what
  74. sort of machine you have (68000, 68020, 68030, 68040) and whether or not it
  75. has an FPU (68020+68881, 68030 with FPU, or 68040 with FPU).  Do something
  76. like the following:
  77.  
  78.     cd gnu:Sys/libs
  79.     copy ixemul040fpu.library ixemul.library clone
  80.  
  81. Then either reboot or run a program to flush the existing ixemul.library (if
  82. any) from memory.  You might also want to review the NEWS file from the docs
  83. archive for changes made since the version from which you have upgraded.
  84. If you installed the ixemul-tz.lha archive you should read ixtimezone.doc
  85. from the docs archive and set your TZ environment variable appropriately.
  86.  
  87. =======================
  88. INSTALLING SOURCE FILES
  89. =======================
  90.  
  91. To extract the source code, simply cd to a directory where you would like
  92. the source code directory to be created, and extract the source archive
  93. there:
  94.  
  95.     cd gnu-src:
  96.     gzip -d ixemul-src.tgz
  97.     tar -xvf ixemul-src.tar
  98.     rm ixemul-src.tar
  99.  
  100. Note that this will create the directory ixemul and populate it with all the
  101. source files.
  102.  
  103. To rebuild the library, all that is needed is to run the configure script
  104. and then run make.  It is recommended that you use separate source and build
  105. directories so you can leave the source tree untouched:
  106.  
  107.     cd gnu-build:
  108.     makedir ixemul
  109.     cd ixemul
  110.     sh /gnu-src/ixemul/configure
  111.  
  112. This will create a Makefile and several subdirectories with other Makefiles.
  113. Note the section in the Makefile that looks like:
  114.  
  115.     all:
  116.         $(MAKE) build CPU=68000 FPU=soft-float BASE=no-baserel
  117.         $(MAKE) build CPU=68000 FPU=soft-float BASE=baserel
  118.         $(MAKE) build CPU=68020 FPU=68881      BASE=no-baserel
  119.         $(MAKE) build CPU=68020 FPU=68881      BASE=baserel
  120.         $(MAKE) build CPU=68020 FPU=soft-float BASE=no-baserel
  121.         $(MAKE) build CPU=68020 FPU=soft-float BASE=baserel
  122.         $(MAKE) build CPU=68030 FPU=68881      BASE=no-baserel
  123.         $(MAKE) build CPU=68030 FPU=68881      BASE=baserel
  124.         $(MAKE) build CPU=68030 FPU=soft-float BASE=no-baserel
  125.         $(MAKE) build CPU=68030 FPU=soft-float BASE=baserel
  126.         $(MAKE) build CPU=68040 FPU=68881      BASE=no-baserel
  127.         $(MAKE) build CPU=68040 FPU=68881      BASE=baserel
  128.         @(cd libsrc && $(MAKE) $(FLAGS_TO_PASS))
  129.  
  130.  
  131. By default, all of the versions of ixemul.library are built by make.  This
  132. can take a relatively long time.  If you only want to build one particular
  133. version of the library and runtime files to test, just comment out the lines
  134. you don't want.  I.E.  to build a 68040+68881 version, the above lines
  135. should be changed to:
  136.  
  137.     all:
  138.         $(MAKE) build CPU=68000 FPU=soft-float BASE=no-baserel
  139.         $(MAKE) build CPU=68000 FPU=soft-float BASE=baserel
  140.     #        $(MAKE) build CPU=68020 FPU=68881      BASE=no-baserel
  141.     #        $(MAKE) build CPU=68020 FPU=68881      BASE=baserel
  142.     #        $(MAKE) build CPU=68020 FPU=soft-float BASE=no-baserel
  143.     #        $(MAKE) build CPU=68020 FPU=soft-float BASE=baserel
  144.     #        $(MAKE) build CPU=68030 FPU=68881      BASE=no-baserel
  145.     #        $(MAKE) build CPU=68030 FPU=68881      BASE=baserel
  146.     #        $(MAKE) build CPU=68030 FPU=soft-float BASE=no-baserel
  147.     #        $(MAKE) build CPU=68030 FPU=soft-float BASE=baserel
  148.         $(MAKE) build CPU=68040 FPU=68881      BASE=no-baserel
  149.         $(MAKE) build CPU=68040 FPU=68881      BASE=baserel
  150.         @(cd libsrc && $(MAKE) $(FLAGS_TO_PASS))
  151.  
  152. Note that you have to build the 68000 version in any case, since the
  153. compiler runtime files (*crt*.o, libc.a, libbc.a) are generic 68000 code.
  154.  
  155. Then just run "make" in the build directory:
  156.  
  157.     cd gnu-build:ixemul
  158.     make
  159.  
  160. Note that you must have a version of GNU make that is newer than the ones
  161. distributed on the FreshFish CDs and on aminet.  Those makes had a patch for
  162. AmigaDOS that nobody used but disabled an important feature that the current
  163. ixemul Makefiles use.  If you have problem compiling the ixemul library get
  164. the lastest ADE make from ftp.amigalib.com:pub/ade or a mirror.
  165.  
  166. =======
  167. IXPREFS
  168. =======
  169.  
  170. Note that effective with ixemul.library 42.0, ixconfig can no longer be
  171. used.  Use ixprefs instead.
  172.  
  173. ==============
  174. REPORTING BUGS
  175. ==============
  176.  
  177. Please report problems or bugs to Hans Verkuil (hans@wyst.hobby.nl), who is
  178. the current ixemul library coordinator.  Even better than a bug report is a
  179. bug fix, which typically would be a context diff file for one or more ixemul
  180. source files.
  181.